revelplayer/com.reveldigital.player.view/[androidJvm]TVView

TVView

open class TVView : RelativeLayout, RevelControl, SurfaceHolder.Callback, MediaPlayer.OnErrorListener, MediaPlayer.OnPreparedListener, MediaPlayer.OnInfoListener, MediaPlayer.OnCompletionListener

A custom RelativeLayout that encapsulates video playback functionality, primarily for displaying TV streams or video content using an underlying ExoPlayerVideoView2.

This view manages the lifecycle of the video player, handles initialization from a Module which specifies video source (URL), volume, VAST ad tags, and scaling options. It implements various MediaPlayer listeners to react to playback events like preparation, completion, and errors.

It also implements RevelControl for integration into the RevelDigital player system, allowing it to be managed as a content module. Error handling includes a retry mechanism for playback issues.

See also

Module

ExoPlayerVideoView2

MediaPlayer.OnErrorListener

MediaPlayer.OnPreparedListener

MediaPlayer.OnInfoListener

MediaPlayer.OnCompletionListener

SurfaceHolder.Callback

Constructors

constructor(context: Context, module: Module)

Constructs a new TVView.

Functions

open fun dispose()

Releases any resources held by this control and prepares it for removal or permanent deactivation.

open fun getName(): String

Gets the unique name assigned to this control.

open fun getOptions(): Iterator<out Option>

Gets an iterator over the configuration s for this control.

open fun getPlaylist(): Playlist

Gets the associated with this control, if any.

open fun getType(): ModuleType

Gets the type of the underlying module or content associated with this control.

open fun getZIndex(): Int

Gets the Z-index (stacking order) of this control.

open fun initialize(module: Module)

Initializes the control with its associated module context.

open fun isAutoStart(): Boolean

Checks if this control is configured to start its operation automatically after #initialize(Module) initialization.

open fun isStarted(): Boolean

Checks if the control is currently in a started or active operational state.

open fun onCompletion(mp: MediaPlayer)

Called when the end of a media source is reached during playback.

open fun onError(mp: MediaPlayer, what: Int, extra: Int): Boolean

Called when an error occurs during media playback.

open fun onInfo(mp: MediaPlayer, what: Int, extra: Int): Boolean

Called to communicate miscellaneous information or warnings during playback.

open fun onPrepared(mp: MediaPlayer)

Called when the media source is ready for playback.

open fun setAutoStart(flag: Boolean)

Sets whether this control should start its operation automatically after #initialize(Module) initialization.

open fun setVolume(volume: Float)

Sets the playback volume for the video.

open fun start()

Starts or resumes the active operation of this control.

open fun stop()

Stops or pauses the active operation of this control.

open fun surfaceChanged(holder: SurfaceHolder, format: Int, width: Int, height: Int)

Called when the surface changes (e.g., size, format).

open fun surfaceCreated(holder: SurfaceHolder)

Called when the surface is first created.

surfaceDestroyed

open fun surfaceDestroyed(holder: SurfaceHolder)

Called when the surface is destroyed.